home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / graphics / ppgram10.arj / PGRAM.TXT < prev    next >
Text File  |  1994-03-09  |  12KB  |  276 lines
  1.  
  2.  
  3.  
  4.                               
  5.                               
  6.                               
  7.                               
  8.                               
  9.                               
  10.                          Propagrams
  11.           The Ultimate in 3D Stereogram Generation
  12.                               
  13.                               
  14.                               
  15.                    Another fine Product by
  16.                      Cedar Lake Software
  17.                               
  18.                               
  19.                               
  20.                               
  21.        Written, Produced, Designed, and Engineered by
  22.                        Matt Witzman &
  23.                          Wayne Pafko
  24.                               
  25.                               
  26.                               
  27.                  (c) 1994  Cedar Lake Software
  28.  
  29.  
  30.                               
  31.                       TABLE OF CONTENTS
  32. TABLE OF CONTENTS                                          1
  33. OVERVIEW                                                   2
  34. WARRANTY                                                   2
  35. REGISTRATION                                               2
  36. GRAPHICS                                                   2
  37. CREATING A PROPAGRAM                                       2
  38. USER INTERFACE                                             3
  39.  MENU SCREEN                                               3
  40.   File Formats                                             3
  41.   Fields and functions                                     4
  42.  PROPAGRAM DISPLAY                                         4
  43. REGISTRATION INFORMATION                                   5
  44.  
  45.  
  46.  
  47.  
  48.  
  49. OVERVIEW
  50. This software converts an ordinary picture (PCX or RAW
  51. format) into a 3D optical illusion called a PROPAGRAM
  52. (Propagating Random Dot Stereogram).   To view a PROPAGRAM
  53. you must focus on a point slightly behind your screen.  This
  54. is accomplished by staying at least 2-3 feet away, and
  55. staring at a reflection in the screen.  If at first you
  56. cannot see anything, have faith and patience, the image is
  57. really there!  If you are having trouble, try relaxing your
  58. eyes, and remember to focus on a point behind the screen.
  59. Many people have to try several times, each effort
  60. consisting of several minutes, before they are successful.
  61. However, the results are definitely worth the effort, and
  62. once your first PROPAGRAM has been successfully viewed, they
  63. become quite easy to see!
  64.  
  65. WARRANTY
  66. CEDAR LAKE SOFTWARE hereby disclaims all warranties relating
  67. to this software, whether express or implied, including
  68. without limitation any implied warranties of merchantability
  69. or fitness for a particular purpose.  CEDAR LAKE SOFTWARE
  70. will not be liable for any special, incidental,
  71. consequential, indirect, or similar damages due to loss of
  72. data or any other reason, even if CEDAR LAKE SOFTWARE has
  73. been advised of the possibility of such damages.  CEDAR LAKE
  74. SOFTWARE's liability for any damages shall never exceed the
  75. price paid for the license to use this software, regardless
  76. of the form of the claim.  The person using this software
  77. bears all risk as to the quality and performance of this
  78. software.
  79.  
  80. REGISTRATION
  81. Unregistered copies of PROPAGRAMS are shareware.  You may
  82. freely distribute unregistered copies as long as all the
  83. original files remain intact without modifications.
  84. Unregistered copies do not have the capability of displaying
  85. PROPAGRAMS in super VGA modes, nor the ability to create
  86. PROPAGRAMS with more than one level of depth.  The sample
  87. images included in this program were created with a
  88. registered version of PROPAGRAMS.  For information on how to
  89. register PROPAGRAMS see the file called `REGISTER.FRM'.
  90.  
  91.  
  92. GRAPHICS
  93. PROPAGRAMS requires a VGA card capable of displaying a
  94. resolution of 320 by 200 pixels with 256 colors.  Registered
  95. versions are also capable of displaying super VGA
  96. resolutions.  Current modes supported by the registered
  97. version are 640x480x256, 800x600x256, and 1024x768x256.
  98. These extended modes require a VGA card that complies with
  99. the VESA VGA v1.2 standard.  If this standard is not built
  100. into your card, you must obtain a driver from the
  101. manufacturer of your VGA card.
  102.  
  103. CREATING A PROPAGRAM
  104. To create the Source file, used to generate a PROPAGRAM, you
  105. need a paint program capable of saving files in a 256 color
  106. PCX or RAW file format.  In the Source file the number of
  107. the color from the palette represents the height the pixel
  108. will assume in the generated PROPAGRAM.  Color zero (0)
  109. represents the lowest possible level in the PROPAGRAM.  As
  110. such, it is recommended that you begin your Source file with
  111. a background color of color zero (0), and work your way up
  112. using higher colors.  It is important to note that the
  113. actual RGB values of the color have no effect on the height,
  114. only the colors location within the palette is of
  115. importance.  Actual colors in the final PROPAGRAM will be
  116. read from the Palette file, not the Source file.
  117.  
  118. NOTE: The maximum height supported by the PROPAGRAM is equal
  119. to one-half the Bandwidth.  Also, unregistered versions of
  120. PROPAGRAMS only support one depth level besides the
  121. background level.
  122.  
  123. NOTE: All data within Bandwidth pixels from the right edge
  124. of your image data will be lost in the resulting PROPAGRAM.
  125. Therefore, it is important to choose your bandwidth to be
  126. large enough to accommodate enough depth levels for your
  127. image, yet small enough to avoid losing too much of your
  128. image.  The increased  super VGA resolutions supported in
  129. the registered version will allow more depths while
  130. minimizing image loss.
  131.  
  132. EXAMPLE: The following screen segment will demonstrate how
  133. to create a pyramid emerging from the background.
  134.                 0  0 0  0 0  0 0  0 0  0
  135.                 0  0 0  0 0  0 0  0 0  0
  136.                 0  0 1  1 1  1 1  1 0  0
  137.                 0  0 1  2 2  2 2  1 0  0
  138.                 0  0 1  2 3  3 2  1 0  0
  139.                 0  0 1  2 3  3 2  1 0  0
  140.                 0  0 1  2 2  2 2  1 0  0
  141.                 0  0 1  1 1  1 1  1 0  0
  142.                 0  0 0  0 0  0 0  0 0  0
  143.                 0  0 0  0 0  0 0  0 0  0
  144.  
  145. USER INTERFACE
  146.  
  147. MENU SCREEN
  148. Screen Layout:  The left half of the screen contains file
  149. entry fields, and program functions.  They right half
  150. contains all the PCX, RAW, and PAL files in the current
  151. directory.  Simply use the arrow keys, in conjunction with
  152. carriage returns, to select and execute all program options.
  153. To select a file from the current directory press <Right
  154. Arrow> when at the end of a file name within a file name
  155. entry field (Source File, Palette, or Save As).  Once you
  156. have moved to the right half of the screen the <Right Arrow>
  157. and <Left Arrow> keys will switch between columns, and bring
  158. you back to the file name entry field.  Pressing <Return>
  159. will select the current file for the field in question.  The
  160. <ESC> key will return from the current directory or file
  161. entry field, and replace the field with the last valid file
  162. name used there.
  163.                               
  164.                               
  165.                         File Formats
  166. The following graphics formats are supported for loading and
  167. saving images.
  168.  
  169. PCX   This graphics format includes both image and palette
  170.       information and is supported by most graphic
  171.       manipulation software.  When viewing a PCX (View)
  172.       both the image and palette information are taken from
  173.       the PCX in the Source File field.  However, when
  174.       generating a PROPAGRAM only image information is read
  175.       from the PCX in the Source File field, while palette
  176.       data is read from the file in the Palette field.  PCX
  177.       files may also be used in the Save As field.
  178. RAW   A RAW file contains uncompressed raw data and no
  179.       palette information.  For a 256 color image each
  180.       color will be represented as one byte so the size of
  181.       this file should be the product of the X and Y
  182.       resolutions (64000, 307200, 480000, or 786432 bytes).
  183.       A RAW file can only be used in the Source File and
  184.       Save As fields.
  185. PAL   This file should be a 768 byte file that contains 256
  186.       sets of three bytes, where each of these three bytes
  187.       corresponds to a red, green, and blue color value.
  188.       PAL files may only be used in the Palette field.
  189.                               
  190.                               
  191.                     Fields and functions
  192.  
  193. Source File:  Contains the file to be converted to a
  194. PROPAGRAM (Make Propagram), or viewed directly (View).  This
  195. file must be in either PCX or RAW format (including
  196. appropriate extension).  If a file is larger than the
  197. current graphics mode, only the upper left-hand portion of
  198. the picture will be displayed and translated into a
  199. PROPAGRAM (what you see is what you get)!
  200.  
  201. Palette: Contains the file used to generate the palette for
  202. the PROPAGRAM (Make Propagram).  This file must be either a
  203. PCX or PAL format (including appropriate extension).
  204.  
  205. Save As: Contains the destination file name to save a
  206. generated PROPAGRAM.  A PROPAGRAM can be saved by pressing
  207. the <S> key while viewing the PROPAGRAM.  The format of the
  208. saved file is determined by the file name extension given
  209. (PCX or RAW).
  210.  
  211. Bandwidth:  The bandwidth determines the distance you must
  212. shift the image to be able to see depth.  Typically this
  213. should correspond to between one and two inches on the
  214. screen.  The bandwidth also determines the maximum number of
  215. distinct depths that can be resolved.  Any depth values over
  216. half the bandwidth will appear at the same depth.  If the
  217. bandwidth is increased to accommodate more depth levels the
  218. PROPAGRAM may be more difficult to see and more of the image
  219. may be lost at the borders.  If the bandwidth is to small
  220. double shifting may occur.
  221.  
  222. Color Begin & Color End: These are the beginning and end
  223. colors from the palette used in the PROPAGRAM.  These colors
  224. must be between 1 and 254 inclusive.
  225.  
  226. Make Propagram:  This option switches to the PROPAGRAM
  227. DISPLAY mode, and creates a PROPAGRAM using the currently
  228. selected files and options.
  229.  
  230. View:  This option will take you to the PROPAGRAM DISPLAY
  231. mode, and view the file in the Source File field in the
  232. current graphics mode.  No PROPAGRAM will be generated.
  233.  
  234. Exit: This option will exit the program.  The <ESC> key will
  235. also exit the program.
  236.  
  237. Graphics Mode: The current graphics mode can be changed by
  238. using the <Left Arrow> and the <Right Arrow> keys or by
  239. pressing the function key (<F1> through <F4>) corresponding
  240. to the desired mode.  If you have a VESA compatible VGA card
  241. and do not see super VGA modes listed make sure your VESA
  242. driver is loaded.  If a video mode is printed in red it
  243. means you must register to use that mode.
  244.                               
  245.  
  246. PROPAGRAM DISPLAY
  247. While the PROPAGRAM is being created the <ESC> key will
  248. abort generation.  The <S> key will save the PROPAGRAM to
  249. the file name found in the SAVE AS field.  The <C> key will
  250. cycle colors.  Cycling speed can then be adjusted using the
  251. number keys (<1> through <9>).  Any other key will exit the
  252. PROPAGRAM DISPLAY mode and bring you back to the MAIN MENU.
  253. For methods of viewing a PROPAGRAM please see the OVERVIEW.
  254.  
  255. REGISTRATION INFORMATION
  256.  
  257. This program may be registered by sending a check or money
  258. order of $25.00 (plus shipping and handling) to:
  259.      Cedar Lake Software
  260.      PO BOX 201103
  261.      Bloomington, MN,  55420-1103
  262.  
  263. Note: Please use the registration form (REGISTER.FRM)!
  264.  
  265. If you have any questions, comments, or suggestions (or just
  266. wanna be friendly) you can contact the authors at: (The
  267. following Internet addresses) 
  268.  
  269. pafk0001@gold.tc.umn.edu,
  270. witz0004@gold.tc.umn.edu,
  271.  
  272. or the mailing address above.
  273.  
  274. The latest version of this program may be obtained from The
  275. WAREHOUSE BBS at (612) 379-8272.
  276.